{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "---\n",
    "\n",
    "_You are currently looking at **version 1.5** of this notebook. To download notebooks and datafiles, as well as get help on Jupyter notebooks in the Coursera platform, visit the [Jupyter Notebook FAQ](https://www.coursera.org/learn/python-data-analysis/resources/0dhYG) course resource._\n",
    "\n",
    "---"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Assignment 3 - More Pandas\n",
    "This assignment requires more individual learning then the last one did - you are encouraged to check out the [pandas documentation](http://pandas.pydata.org/pandas-docs/stable/) to find functions or methods you might not have used yet, or ask questions on [Stack Overflow](http://stackoverflow.com/) and tag them as pandas and python related. And of course, the discussion forums are open for interaction with your peers and the course staff."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 1 (20%)\n",
    "Load the energy data from the file `Energy Indicators.xls`, which is a list of indicators of [energy supply and renewable electricity production](Energy%20Indicators.xls) from the [United Nations](http://unstats.un.org/unsd/environment/excel_file_tables/2013/Energy%20Indicators.xls) for the year 2013, and should be put into a DataFrame with the variable name of **energy**.\n",
    "\n",
    "Keep in mind that this is an Excel file, and not a comma separated values file. Also, make sure to exclude the footer and header information from the datafile. The first two columns are unneccessary, so you should get rid of them, and you should change the column labels so that the columns are:\n",
    "\n",
    "`['Country', 'Energy Supply', 'Energy Supply per Capita', '% Renewable']`\n",
    "\n",
    "Convert `Energy Supply` to gigajoules (there are 1,000,000 gigajoules in a petajoule). For all countries which have missing data (e.g. data with \"...\") make sure this is reflected as `np.NaN` values.\n",
    "\n",
    "Rename the following list of countries (for use in later questions):\n",
    "\n",
    "```\"Republic of Korea\": \"South Korea\",\n",
    "\"United States of America\": \"United States\",\n",
    "\"United Kingdom of Great Britain and Northern Ireland\": \"United Kingdom\",\n",
    "\"China, Hong Kong Special Administrative Region\": \"Hong Kong\"```\n",
    "\n",
    "There are also several countries with numbers and/or parenthesis in their name. Be sure to remove these, \n",
    "\n",
    "e.g. \n",
    "\n",
    "`'Bolivia (Plurinational State of)'` should be `'Bolivia'`, \n",
    "\n",
    "`'Switzerland17'` should be `'Switzerland'`.\n",
    "\n",
    "<br>\n",
    "\n",
    "Next, load the GDP data from the file `world_bank.csv`, which is a csv containing countries' GDP from 1960 to 2015 from [World Bank](http://data.worldbank.org/indicator/NY.GDP.MKTP.CD). Call this DataFrame **GDP**. \n",
    "\n",
    "Make sure to skip the header, and rename the following list of countries:\n",
    "\n",
    "```\"Korea, Rep.\": \"South Korea\", \n",
    "\"Iran, Islamic Rep.\": \"Iran\",\n",
    "\"Hong Kong SAR, China\": \"Hong Kong\"```\n",
    "\n",
    "<br>\n",
    "\n",
    "Finally, load the [Sciamgo Journal and Country Rank data for Energy Engineering and Power Technology](http://www.scimagojr.com/countryrank.php?category=2102) from the file `scimagojr-3.xlsx`, which ranks countries based on their journal contributions in the aforementioned area. Call this DataFrame **ScimEn**.\n",
    "\n",
    "Join the three datasets: GDP, Energy, and ScimEn into a new dataset (using the intersection of country names). Use only the last 10 years (2006-2015) of GDP data and only the top 15 countries by Scimagojr 'Rank' (Rank 1 through 15). \n",
    "\n",
    "The index of this DataFrame should be the name of the country, and the columns should be ['Rank', 'Documents', 'Citable documents', 'Citations', 'Self-citations',\n",
    "       'Citations per document', 'H index', 'Energy Supply',\n",
    "       'Energy Supply per Capita', '% Renewable', '2006', '2007', '2008',\n",
    "       '2009', '2010', '2011', '2012', '2013', '2014', '2015'].\n",
    "\n",
    "\n",
    "*This function should return a DataFrame with 20 columns and 15 entries.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 67,
   "metadata": {
    "umich_part_id": "009",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Rank</th>\n",
       "      <th>Documents</th>\n",
       "      <th>Citable documents</th>\n",
       "      <th>Citations</th>\n",
       "      <th>Self-citations</th>\n",
       "      <th>Citations per document</th>\n",
       "      <th>H index</th>\n",
       "      <th>Energy Supply</th>\n",
       "      <th>Energy Supply per Capita</th>\n",
       "      <th>% Renewable</th>\n",
       "      <th>2006</th>\n",
       "      <th>2007</th>\n",
       "      <th>2008</th>\n",
       "      <th>2009</th>\n",
       "      <th>2010</th>\n",
       "      <th>2011</th>\n",
       "      <th>2012</th>\n",
       "      <th>2013</th>\n",
       "      <th>2014</th>\n",
       "      <th>2015</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Country</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>China</th>\n",
       "      <td>1</td>\n",
       "      <td>127050</td>\n",
       "      <td>126767</td>\n",
       "      <td>597237</td>\n",
       "      <td>411683</td>\n",
       "      <td>4.70</td>\n",
       "      <td>138</td>\n",
       "      <td>1.271910e+11</td>\n",
       "      <td>93.0</td>\n",
       "      <td>19.754910</td>\n",
       "      <td>3.992331e+12</td>\n",
       "      <td>4.559041e+12</td>\n",
       "      <td>4.997775e+12</td>\n",
       "      <td>5.459247e+12</td>\n",
       "      <td>6.039659e+12</td>\n",
       "      <td>6.612490e+12</td>\n",
       "      <td>7.124978e+12</td>\n",
       "      <td>7.672448e+12</td>\n",
       "      <td>8.230121e+12</td>\n",
       "      <td>8.797999e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>United States</th>\n",
       "      <td>2</td>\n",
       "      <td>96661</td>\n",
       "      <td>94747</td>\n",
       "      <td>792274</td>\n",
       "      <td>265436</td>\n",
       "      <td>8.20</td>\n",
       "      <td>230</td>\n",
       "      <td>9.083800e+10</td>\n",
       "      <td>286.0</td>\n",
       "      <td>11.570980</td>\n",
       "      <td>1.479230e+13</td>\n",
       "      <td>1.505540e+13</td>\n",
       "      <td>1.501149e+13</td>\n",
       "      <td>1.459484e+13</td>\n",
       "      <td>1.496437e+13</td>\n",
       "      <td>1.520402e+13</td>\n",
       "      <td>1.554216e+13</td>\n",
       "      <td>1.577367e+13</td>\n",
       "      <td>1.615662e+13</td>\n",
       "      <td>1.654857e+13</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Japan</th>\n",
       "      <td>3</td>\n",
       "      <td>30504</td>\n",
       "      <td>30287</td>\n",
       "      <td>223024</td>\n",
       "      <td>61554</td>\n",
       "      <td>7.31</td>\n",
       "      <td>134</td>\n",
       "      <td>1.898400e+10</td>\n",
       "      <td>149.0</td>\n",
       "      <td>10.232820</td>\n",
       "      <td>5.496542e+12</td>\n",
       "      <td>5.617036e+12</td>\n",
       "      <td>5.558527e+12</td>\n",
       "      <td>5.251308e+12</td>\n",
       "      <td>5.498718e+12</td>\n",
       "      <td>5.473738e+12</td>\n",
       "      <td>5.569102e+12</td>\n",
       "      <td>5.644659e+12</td>\n",
       "      <td>5.642884e+12</td>\n",
       "      <td>5.669563e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>United Kingdom</th>\n",
       "      <td>4</td>\n",
       "      <td>20944</td>\n",
       "      <td>20357</td>\n",
       "      <td>206091</td>\n",
       "      <td>37874</td>\n",
       "      <td>9.84</td>\n",
       "      <td>139</td>\n",
       "      <td>7.920000e+09</td>\n",
       "      <td>124.0</td>\n",
       "      <td>10.600470</td>\n",
       "      <td>2.419631e+12</td>\n",
       "      <td>2.482203e+12</td>\n",
       "      <td>2.470614e+12</td>\n",
       "      <td>2.367048e+12</td>\n",
       "      <td>2.403504e+12</td>\n",
       "      <td>2.450911e+12</td>\n",
       "      <td>2.479809e+12</td>\n",
       "      <td>2.533370e+12</td>\n",
       "      <td>2.605643e+12</td>\n",
       "      <td>2.666333e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Russian Federation</th>\n",
       "      <td>5</td>\n",
       "      <td>18534</td>\n",
       "      <td>18301</td>\n",
       "      <td>34266</td>\n",
       "      <td>12422</td>\n",
       "      <td>1.85</td>\n",
       "      <td>57</td>\n",
       "      <td>3.070900e+10</td>\n",
       "      <td>214.0</td>\n",
       "      <td>17.288680</td>\n",
       "      <td>1.385793e+12</td>\n",
       "      <td>1.504071e+12</td>\n",
       "      <td>1.583004e+12</td>\n",
       "      <td>1.459199e+12</td>\n",
       "      <td>1.524917e+12</td>\n",
       "      <td>1.589943e+12</td>\n",
       "      <td>1.645876e+12</td>\n",
       "      <td>1.666934e+12</td>\n",
       "      <td>1.678709e+12</td>\n",
       "      <td>1.616149e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Canada</th>\n",
       "      <td>6</td>\n",
       "      <td>17899</td>\n",
       "      <td>17620</td>\n",
       "      <td>215003</td>\n",
       "      <td>40930</td>\n",
       "      <td>12.01</td>\n",
       "      <td>149</td>\n",
       "      <td>1.043100e+10</td>\n",
       "      <td>296.0</td>\n",
       "      <td>61.945430</td>\n",
       "      <td>1.564469e+12</td>\n",
       "      <td>1.596740e+12</td>\n",
       "      <td>1.612713e+12</td>\n",
       "      <td>1.565145e+12</td>\n",
       "      <td>1.613406e+12</td>\n",
       "      <td>1.664087e+12</td>\n",
       "      <td>1.693133e+12</td>\n",
       "      <td>1.730688e+12</td>\n",
       "      <td>1.773486e+12</td>\n",
       "      <td>1.792609e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Germany</th>\n",
       "      <td>7</td>\n",
       "      <td>17027</td>\n",
       "      <td>16831</td>\n",
       "      <td>140566</td>\n",
       "      <td>27426</td>\n",
       "      <td>8.26</td>\n",
       "      <td>126</td>\n",
       "      <td>1.326100e+10</td>\n",
       "      <td>165.0</td>\n",
       "      <td>17.901530</td>\n",
       "      <td>3.332891e+12</td>\n",
       "      <td>3.441561e+12</td>\n",
       "      <td>3.478809e+12</td>\n",
       "      <td>3.283340e+12</td>\n",
       "      <td>3.417298e+12</td>\n",
       "      <td>3.542371e+12</td>\n",
       "      <td>3.556724e+12</td>\n",
       "      <td>3.567317e+12</td>\n",
       "      <td>3.624386e+12</td>\n",
       "      <td>3.685556e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>India</th>\n",
       "      <td>8</td>\n",
       "      <td>15005</td>\n",
       "      <td>14841</td>\n",
       "      <td>128763</td>\n",
       "      <td>37209</td>\n",
       "      <td>8.58</td>\n",
       "      <td>115</td>\n",
       "      <td>3.319500e+10</td>\n",
       "      <td>26.0</td>\n",
       "      <td>14.969080</td>\n",
       "      <td>1.265894e+12</td>\n",
       "      <td>1.374865e+12</td>\n",
       "      <td>1.428361e+12</td>\n",
       "      <td>1.549483e+12</td>\n",
       "      <td>1.708459e+12</td>\n",
       "      <td>1.821872e+12</td>\n",
       "      <td>1.924235e+12</td>\n",
       "      <td>2.051982e+12</td>\n",
       "      <td>2.200617e+12</td>\n",
       "      <td>2.367206e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>France</th>\n",
       "      <td>9</td>\n",
       "      <td>13153</td>\n",
       "      <td>12973</td>\n",
       "      <td>130632</td>\n",
       "      <td>28601</td>\n",
       "      <td>9.93</td>\n",
       "      <td>114</td>\n",
       "      <td>1.059700e+10</td>\n",
       "      <td>166.0</td>\n",
       "      <td>17.020280</td>\n",
       "      <td>2.607840e+12</td>\n",
       "      <td>2.669424e+12</td>\n",
       "      <td>2.674637e+12</td>\n",
       "      <td>2.595967e+12</td>\n",
       "      <td>2.646995e+12</td>\n",
       "      <td>2.702032e+12</td>\n",
       "      <td>2.706968e+12</td>\n",
       "      <td>2.722567e+12</td>\n",
       "      <td>2.729632e+12</td>\n",
       "      <td>2.761185e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>South Korea</th>\n",
       "      <td>10</td>\n",
       "      <td>11983</td>\n",
       "      <td>11923</td>\n",
       "      <td>114675</td>\n",
       "      <td>22595</td>\n",
       "      <td>9.57</td>\n",
       "      <td>104</td>\n",
       "      <td>1.100700e+10</td>\n",
       "      <td>221.0</td>\n",
       "      <td>2.279353</td>\n",
       "      <td>9.410199e+11</td>\n",
       "      <td>9.924316e+11</td>\n",
       "      <td>1.020510e+12</td>\n",
       "      <td>1.027730e+12</td>\n",
       "      <td>1.094499e+12</td>\n",
       "      <td>1.134796e+12</td>\n",
       "      <td>1.160809e+12</td>\n",
       "      <td>1.194429e+12</td>\n",
       "      <td>1.234340e+12</td>\n",
       "      <td>1.266580e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Italy</th>\n",
       "      <td>11</td>\n",
       "      <td>10964</td>\n",
       "      <td>10794</td>\n",
       "      <td>111850</td>\n",
       "      <td>26661</td>\n",
       "      <td>10.20</td>\n",
       "      <td>106</td>\n",
       "      <td>6.530000e+09</td>\n",
       "      <td>109.0</td>\n",
       "      <td>33.667230</td>\n",
       "      <td>2.202170e+12</td>\n",
       "      <td>2.234627e+12</td>\n",
       "      <td>2.211154e+12</td>\n",
       "      <td>2.089938e+12</td>\n",
       "      <td>2.125185e+12</td>\n",
       "      <td>2.137439e+12</td>\n",
       "      <td>2.077184e+12</td>\n",
       "      <td>2.040871e+12</td>\n",
       "      <td>2.033868e+12</td>\n",
       "      <td>2.049316e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Spain</th>\n",
       "      <td>12</td>\n",
       "      <td>9428</td>\n",
       "      <td>9330</td>\n",
       "      <td>123336</td>\n",
       "      <td>23964</td>\n",
       "      <td>13.08</td>\n",
       "      <td>115</td>\n",
       "      <td>4.923000e+09</td>\n",
       "      <td>106.0</td>\n",
       "      <td>37.968590</td>\n",
       "      <td>1.414823e+12</td>\n",
       "      <td>1.468146e+12</td>\n",
       "      <td>1.484530e+12</td>\n",
       "      <td>1.431475e+12</td>\n",
       "      <td>1.431673e+12</td>\n",
       "      <td>1.417355e+12</td>\n",
       "      <td>1.380216e+12</td>\n",
       "      <td>1.357139e+12</td>\n",
       "      <td>1.375605e+12</td>\n",
       "      <td>1.419821e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Iran</th>\n",
       "      <td>13</td>\n",
       "      <td>8896</td>\n",
       "      <td>8819</td>\n",
       "      <td>57470</td>\n",
       "      <td>19125</td>\n",
       "      <td>6.46</td>\n",
       "      <td>72</td>\n",
       "      <td>9.172000e+09</td>\n",
       "      <td>119.0</td>\n",
       "      <td>5.707721</td>\n",
       "      <td>3.895523e+11</td>\n",
       "      <td>4.250646e+11</td>\n",
       "      <td>4.289909e+11</td>\n",
       "      <td>4.389208e+11</td>\n",
       "      <td>4.677902e+11</td>\n",
       "      <td>4.853309e+11</td>\n",
       "      <td>4.532569e+11</td>\n",
       "      <td>4.445926e+11</td>\n",
       "      <td>4.639027e+11</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Australia</th>\n",
       "      <td>14</td>\n",
       "      <td>8831</td>\n",
       "      <td>8725</td>\n",
       "      <td>90765</td>\n",
       "      <td>15606</td>\n",
       "      <td>10.28</td>\n",
       "      <td>107</td>\n",
       "      <td>5.386000e+09</td>\n",
       "      <td>231.0</td>\n",
       "      <td>11.810810</td>\n",
       "      <td>1.021939e+12</td>\n",
       "      <td>1.060340e+12</td>\n",
       "      <td>1.099644e+12</td>\n",
       "      <td>1.119654e+12</td>\n",
       "      <td>1.142251e+12</td>\n",
       "      <td>1.169431e+12</td>\n",
       "      <td>1.211913e+12</td>\n",
       "      <td>1.241484e+12</td>\n",
       "      <td>1.272520e+12</td>\n",
       "      <td>1.301251e+12</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Brazil</th>\n",
       "      <td>15</td>\n",
       "      <td>8668</td>\n",
       "      <td>8596</td>\n",
       "      <td>60702</td>\n",
       "      <td>14396</td>\n",
       "      <td>7.00</td>\n",
       "      <td>86</td>\n",
       "      <td>1.214900e+10</td>\n",
       "      <td>59.0</td>\n",
       "      <td>69.648030</td>\n",
       "      <td>1.845080e+12</td>\n",
       "      <td>1.957118e+12</td>\n",
       "      <td>2.056809e+12</td>\n",
       "      <td>2.054215e+12</td>\n",
       "      <td>2.208872e+12</td>\n",
       "      <td>2.295245e+12</td>\n",
       "      <td>2.339209e+12</td>\n",
       "      <td>2.409740e+12</td>\n",
       "      <td>2.412231e+12</td>\n",
       "      <td>2.319423e+12</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "                    Rank  Documents  Citable documents  Citations  \\\n",
       "Country                                                             \n",
       "China                  1     127050             126767     597237   \n",
       "United States          2      96661              94747     792274   \n",
       "Japan                  3      30504              30287     223024   \n",
       "United Kingdom         4      20944              20357     206091   \n",
       "Russian Federation     5      18534              18301      34266   \n",
       "Canada                 6      17899              17620     215003   \n",
       "Germany                7      17027              16831     140566   \n",
       "India                  8      15005              14841     128763   \n",
       "France                 9      13153              12973     130632   \n",
       "South Korea           10      11983              11923     114675   \n",
       "Italy                 11      10964              10794     111850   \n",
       "Spain                 12       9428               9330     123336   \n",
       "Iran                  13       8896               8819      57470   \n",
       "Australia             14       8831               8725      90765   \n",
       "Brazil                15       8668               8596      60702   \n",
       "\n",
       "                    Self-citations  Citations per document  H index  \\\n",
       "Country                                                               \n",
       "China                       411683                    4.70      138   \n",
       "United States               265436                    8.20      230   \n",
       "Japan                        61554                    7.31      134   \n",
       "United Kingdom               37874                    9.84      139   \n",
       "Russian Federation           12422                    1.85       57   \n",
       "Canada                       40930                   12.01      149   \n",
       "Germany                      27426                    8.26      126   \n",
       "India                        37209                    8.58      115   \n",
       "France                       28601                    9.93      114   \n",
       "South Korea                  22595                    9.57      104   \n",
       "Italy                        26661                   10.20      106   \n",
       "Spain                        23964                   13.08      115   \n",
       "Iran                         19125                    6.46       72   \n",
       "Australia                    15606                   10.28      107   \n",
       "Brazil                       14396                    7.00       86   \n",
       "\n",
       "                    Energy Supply  Energy Supply per Capita  % Renewable  \\\n",
       "Country                                                                    \n",
       "China                1.271910e+11                      93.0    19.754910   \n",
       "United States        9.083800e+10                     286.0    11.570980   \n",
       "Japan                1.898400e+10                     149.0    10.232820   \n",
       "United Kingdom       7.920000e+09                     124.0    10.600470   \n",
       "Russian Federation   3.070900e+10                     214.0    17.288680   \n",
       "Canada               1.043100e+10                     296.0    61.945430   \n",
       "Germany              1.326100e+10                     165.0    17.901530   \n",
       "India                3.319500e+10                      26.0    14.969080   \n",
       "France               1.059700e+10                     166.0    17.020280   \n",
       "South Korea          1.100700e+10                     221.0     2.279353   \n",
       "Italy                6.530000e+09                     109.0    33.667230   \n",
       "Spain                4.923000e+09                     106.0    37.968590   \n",
       "Iran                 9.172000e+09                     119.0     5.707721   \n",
       "Australia            5.386000e+09                     231.0    11.810810   \n",
       "Brazil               1.214900e+10                      59.0    69.648030   \n",
       "\n",
       "                            2006          2007          2008          2009  \\\n",
       "Country                                                                      \n",
       "China               3.992331e+12  4.559041e+12  4.997775e+12  5.459247e+12   \n",
       "United States       1.479230e+13  1.505540e+13  1.501149e+13  1.459484e+13   \n",
       "Japan               5.496542e+12  5.617036e+12  5.558527e+12  5.251308e+12   \n",
       "United Kingdom      2.419631e+12  2.482203e+12  2.470614e+12  2.367048e+12   \n",
       "Russian Federation  1.385793e+12  1.504071e+12  1.583004e+12  1.459199e+12   \n",
       "Canada              1.564469e+12  1.596740e+12  1.612713e+12  1.565145e+12   \n",
       "Germany             3.332891e+12  3.441561e+12  3.478809e+12  3.283340e+12   \n",
       "India               1.265894e+12  1.374865e+12  1.428361e+12  1.549483e+12   \n",
       "France              2.607840e+12  2.669424e+12  2.674637e+12  2.595967e+12   \n",
       "South Korea         9.410199e+11  9.924316e+11  1.020510e+12  1.027730e+12   \n",
       "Italy               2.202170e+12  2.234627e+12  2.211154e+12  2.089938e+12   \n",
       "Spain               1.414823e+12  1.468146e+12  1.484530e+12  1.431475e+12   \n",
       "Iran                3.895523e+11  4.250646e+11  4.289909e+11  4.389208e+11   \n",
       "Australia           1.021939e+12  1.060340e+12  1.099644e+12  1.119654e+12   \n",
       "Brazil              1.845080e+12  1.957118e+12  2.056809e+12  2.054215e+12   \n",
       "\n",
       "                            2010          2011          2012          2013  \\\n",
       "Country                                                                      \n",
       "China               6.039659e+12  6.612490e+12  7.124978e+12  7.672448e+12   \n",
       "United States       1.496437e+13  1.520402e+13  1.554216e+13  1.577367e+13   \n",
       "Japan               5.498718e+12  5.473738e+12  5.569102e+12  5.644659e+12   \n",
       "United Kingdom      2.403504e+12  2.450911e+12  2.479809e+12  2.533370e+12   \n",
       "Russian Federation  1.524917e+12  1.589943e+12  1.645876e+12  1.666934e+12   \n",
       "Canada              1.613406e+12  1.664087e+12  1.693133e+12  1.730688e+12   \n",
       "Germany             3.417298e+12  3.542371e+12  3.556724e+12  3.567317e+12   \n",
       "India               1.708459e+12  1.821872e+12  1.924235e+12  2.051982e+12   \n",
       "France              2.646995e+12  2.702032e+12  2.706968e+12  2.722567e+12   \n",
       "South Korea         1.094499e+12  1.134796e+12  1.160809e+12  1.194429e+12   \n",
       "Italy               2.125185e+12  2.137439e+12  2.077184e+12  2.040871e+12   \n",
       "Spain               1.431673e+12  1.417355e+12  1.380216e+12  1.357139e+12   \n",
       "Iran                4.677902e+11  4.853309e+11  4.532569e+11  4.445926e+11   \n",
       "Australia           1.142251e+12  1.169431e+12  1.211913e+12  1.241484e+12   \n",
       "Brazil              2.208872e+12  2.295245e+12  2.339209e+12  2.409740e+12   \n",
       "\n",
       "                            2014          2015  \n",
       "Country                                         \n",
       "China               8.230121e+12  8.797999e+12  \n",
       "United States       1.615662e+13  1.654857e+13  \n",
       "Japan               5.642884e+12  5.669563e+12  \n",
       "United Kingdom      2.605643e+12  2.666333e+12  \n",
       "Russian Federation  1.678709e+12  1.616149e+12  \n",
       "Canada              1.773486e+12  1.792609e+12  \n",
       "Germany             3.624386e+12  3.685556e+12  \n",
       "India               2.200617e+12  2.367206e+12  \n",
       "France              2.729632e+12  2.761185e+12  \n",
       "South Korea         1.234340e+12  1.266580e+12  \n",
       "Italy               2.033868e+12  2.049316e+12  \n",
       "Spain               1.375605e+12  1.419821e+12  \n",
       "Iran                4.639027e+11           NaN  \n",
       "Australia           1.272520e+12  1.301251e+12  \n",
       "Brazil              2.412231e+12  2.319423e+12  "
      ]
     },
     "execution_count": 67,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import pandas as pd\n",
    "import numpy as np\n",
    "\n",
    "def answer_one():\n",
    "    \n",
    "    #Energy Indicators\n",
    "    \n",
    "    energy = pd.read_excel('Energy Indicators.xls', skiprows = 17, skip_footer = 38)\n",
    "    energy = energy[[1,3,4,5]]\n",
    "    energy = energy.rename(columns={ 'Unnamed: 1' : 'Country', 'Petajoules' : 'Energy Supply', 'Gigajoules' : 'Energy Supply per Capita', '%' : '% Renewable'})\n",
    "    #Alternatively to rename the columns:\n",
    "    #energy.columns = [['Country', 'Energy Supply', 'Energy Supply per Capita', '% Renewable']]\n",
    "    energy[['Energy Supply', 'Energy Supply per Capita', '% Renewable']] =  energy[['Energy Supply', 'Energy Supply per Capita', '% Renewable']].replace('...',np.NaN).apply(pd.to_numeric)\n",
    "    energy['Energy Supply'] = 1000000 * energy['Energy Supply']\n",
    "    energy['Country'] = energy['Country'].replace({\"Republic of Korea\": \"South Korea\",\n",
    "                                    \"United States of America\": \"United States\",\n",
    "                                    \"United Kingdom of Great Britain and Northern Ireland\": \"United Kingdom\",\n",
    "                                    \"China, Hong Kong Special Administrative Region\": \"Hong Kong\"})\n",
    "    #Removing parenthesis in country name\n",
    "    energy['Country'] = energy['Country'].str.replace(r\" \\(.*\\)\",\"\")\n",
    "    #Removing numbers in country name\n",
    "    energy['Country'] = energy['Country'].str.replace('\\d+', '')\n",
    "    \n",
    "    #GDP\n",
    "    \n",
    "    GDP = pd.read_csv('world_bank.csv', skiprows = 4)\n",
    "    GDP = GDP.rename(columns={'Country Name' : 'Country'})\n",
    "    GDP['Country'] = GDP['Country'].replace({\"Korea, Rep.\": \"South Korea\", \n",
    "                                \"Iran, Islamic Rep.\": \"Iran\",\n",
    "                                \"Hong Kong SAR, China\": \"Hong Kong\"})\n",
    "    \n",
    "    #Sciamgo Journal and Country Rank data for Energy Engineering and Power Technology\n",
    "    \n",
    "    ScimEn = pd.read_excel('scimagojr-3.xlsx')\n",
    "    \n",
    "    #Join energy, GDP, ScimEn\n",
    "    \n",
    "    join_energy_GDP = pd.merge(ScimEn[:15], GDP[['Country', '2006','2007','2008','2009','2010','2011','2012','2013','2014','2015']], how = 'inner', left_on = 'Country', right_on = 'Country')\n",
    "    join = pd.merge(join_energy_GDP, energy, how = 'inner', left_on = 'Country', right_on = 'Country')\n",
    "\n",
    "#     Alternative solution:\n",
    "#     join = pd.merge((pd.merge(ScimEn[:15], energy, how = 'inner', left_on = 'Country', right_on='Country')), GDP[['Country', '2006','2007','2008','2009','2010','2011','2012','2013','2014','2015']], how = 'inner', left_on = 'Country', right_on='Country')  \n",
    "\n",
    "    \n",
    "    join = join.set_index('Country')\n",
    "    join = join[['Rank', 'Documents', 'Citable documents', 'Citations', 'Self-citations', 'Citations per document', 'H index', 'Energy Supply', 'Energy Supply per Capita', '% Renewable', '2006', '2007', '2008', '2009', '2010', '2011', '2012', '2013', '2014', '2015']]\n",
    "    \n",
    "    return join\n",
    "\n",
    "answer_one()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 2 (6.6%)\n",
    "The previous question joined three datasets then reduced this to just the top 15 entries. When you joined the datasets, but before you reduced this to the top 15 items, how many entries did you lose?\n",
    "\n",
    "*This function should return a single number.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 92,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<svg width=\"800\" height=\"300\">\n",
       "  <circle cx=\"150\" cy=\"180\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"blue\" />\n",
       "  <circle cx=\"200\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"red\" />\n",
       "  <circle cx=\"100\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"green\" />\n",
       "  <line x1=\"150\" y1=\"125\" x2=\"300\" y2=\"150\" stroke=\"black\" stroke-width=\"2\" fill=\"black\" stroke-dasharray=\"5,3\"/>\n",
       "  <text  x=\"300\" y=\"165\" font-family=\"Verdana\" font-size=\"35\">Everything but this!</text>\n",
       "</svg>"
      ],
      "text/plain": [
       "<IPython.core.display.HTML object>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "%%HTML\n",
    "<svg width=\"800\" height=\"300\">\n",
    "  <circle cx=\"150\" cy=\"180\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"blue\" />\n",
    "  <circle cx=\"200\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"red\" />\n",
    "  <circle cx=\"100\" cy=\"100\" r=\"80\" fill-opacity=\"0.2\" stroke=\"black\" stroke-width=\"2\" fill=\"green\" />\n",
    "  <line x1=\"150\" y1=\"125\" x2=\"300\" y2=\"150\" stroke=\"black\" stroke-width=\"2\" fill=\"black\" stroke-dasharray=\"5,3\"/>\n",
    "  <text  x=\"300\" y=\"165\" font-family=\"Verdana\" font-size=\"35\">Everything but this!</text>\n",
    "</svg>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 75,
   "metadata": {
    "umich_part_id": "010",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "156"
      ]
     },
     "execution_count": 75,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_two():\n",
    "\n",
    "  #Energy Indicators\n",
    "    \n",
    "    energy = pd.read_excel('Energy Indicators.xls', skiprows = 17, skip_footer = 38)\n",
    "#     energy = energy[[1,3,4,5]]\n",
    "    energy = energy[['Unnamed: 1','Petajoules','Gigajoules','%']]\n",
    "    energy = energy.rename(columns={ 'Unnamed: 1' : 'Country', 'Petajoules' : 'Energy Supply', 'Gigajoules' : 'Energy Supply per Capita', '%' : '% Renewable'})\n",
    "    #Alternatively to rename the columns:\n",
    "    #energy.columns = [['Country', 'Energy Supply', 'Energy Supply per Capita', '% Renewable']]\n",
    "    energy[['Energy Supply', 'Energy Supply per Capita', '% Renewable']] =  energy[['Energy Supply', 'Energy Supply per Capita', '% Renewable']].replace('...',np.NaN).apply(pd.to_numeric)\n",
    "    energy['Energy Supply'] = 1000000 * energy['Energy Supply']\n",
    "    energy['Country'] = energy['Country'].replace({\"Republic of Korea\": \"South Korea\",\n",
    "                                    \"United States of America\": \"United States\",\n",
    "                                    \"United Kingdom of Great Britain and Northern Ireland\": \"United Kingdom\",\n",
    "                                    \"China, Hong Kong Special Administrative Region\": \"Hong Kong\"})\n",
    "#     Removing parenthesis in country name\n",
    "    energy['Country'] = energy['Country'].str.replace(r\" \\(.*\\)\",\"\")\n",
    "#     Removing numbers in country name\n",
    "    energy['Country'] = energy['Country'].str.replace('\\d+', '')\n",
    "    \n",
    "    #GDP\n",
    "    \n",
    "    GDP = pd.read_csv('world_bank.csv', skiprows = 4)\n",
    "    GDP = GDP.rename(columns={'Country Name' : 'Country'})\n",
    "    GDP['Country'] = GDP['Country'].replace({\"Korea, Rep.\": \"South Korea\", \n",
    "                                \"Iran, Islamic Rep.\": \"Iran\",\n",
    "                                \"Hong Kong SAR, China\": \"Hong Kong\"})\n",
    "    \n",
    "    #Sciamgo Journal and Country Rank data for Energy Engineering and Power Technology\n",
    "    \n",
    "    ScimEn = pd.read_excel('scimagojr-3.xlsx')\n",
    "    \n",
    "    #Join\n",
    "      \n",
    "    outer = pd.merge((pd.merge(ScimEn, energy, how = 'outer', left_on = 'Country', right_on='Country')), GDP, how = 'outer', left_on = 'Country', right_on='Country')  \n",
    "    inner = pd.merge((pd.merge(ScimEn, energy, how = 'inner', left_on = 'Country', right_on='Country')), GDP, how = 'inner', left_on = 'Country', right_on='Country')  \n",
    "    \n",
    "    return len(outer) - len(inner)\n",
    "\n",
    "answer_two()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Answer the following questions in the context of only the top 15 countries by Scimagojr Rank (aka the DataFrame returned by `answer_one()`)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 3 (6.6%)\n",
    "What is the average GDP over the last 10 years for each country? (exclude missing values from this calculation.)\n",
    "\n",
    "*This function should return a Series named `avgGDP` with 15 countries and their average GDP sorted in descending order.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 94,
   "metadata": {
    "scrolled": true,
    "umich_part_id": "011",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Country\n",
       "United States         1.536434e+13\n",
       "China                 6.348609e+12\n",
       "Japan                 5.542208e+12\n",
       "Germany               3.493025e+12\n",
       "France                2.681725e+12\n",
       "United Kingdom        2.487907e+12\n",
       "Brazil                2.189794e+12\n",
       "Italy                 2.120175e+12\n",
       "India                 1.769297e+12\n",
       "Canada                1.660647e+12\n",
       "Russian Federation    1.565459e+12\n",
       "Spain                 1.418078e+12\n",
       "Australia             1.164043e+12\n",
       "South Korea           1.106715e+12\n",
       "dtype: float64"
      ]
     },
     "execution_count": 94,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_three():\n",
    "    Top15 = answer_one()\n",
    "    rows = ['2006','2007','2008','2009','2010','2011','2012','2013','2014','2015']\n",
    "    avgGDP = Top15.apply(lambda x : np.average(x[rows]), axis = 1).dropna()\n",
    "    avgGDP = avgGDP.sort_values(ascending = False)\n",
    "    return avgGDP\n",
    "\n",
    "answer_three()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 4 (6.6%)\n",
    "By how much had the GDP changed over the 10 year span for the country with the 6th largest average GDP?\n",
    "\n",
    "*This function should return a single number.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 109,
   "metadata": {
    "scrolled": true,
    "umich_part_id": "012",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "246702696075.3999"
      ]
     },
     "execution_count": 109,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_four():\n",
    "    Top15 = answer_one()\n",
    "    rows = ['2006','2007','2008','2009','2010','2011','2012','2013','2014','2015']\n",
    "    avgGDP = Top15.apply(lambda x : np.average(x[rows]), axis = 1).dropna()\n",
    "    avgGDP = avgGDP.sort_values(ascending = False)\n",
    "    return Top15.loc[avgGDP.index[5]]['2015'] - Top15.loc[avgGDP.index[5]]['2006']\n",
    "\n",
    "#     Alternatives:\n",
    "#     Top15 = answer_one()\n",
    "#     Top15[\"AvgGDP\"] = answer_three()\n",
    "#     Top15.sort_values(\"AvgGDP\", ascending=False, inplace=True)\n",
    "#     final = Top15.iloc[5]['2015']\n",
    "#     initial = Top15.iloc[5]['2006']\n",
    "#     return abs(final - initial)\n",
    "\n",
    "answer_four()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 5 (6.6%)\n",
    "What is the mean `Energy Supply per Capita`?\n",
    "\n",
    "*This function should return a single number.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 110,
   "metadata": {
    "umich_part_id": "013",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "157.59999999999999"
      ]
     },
     "execution_count": 110,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_five():\n",
    "    Top15 = answer_one()\n",
    "    mean = Top15['Energy Supply per Capita'].mean()\n",
    "    return mean\n",
    "\n",
    "answer_five()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 6 (6.6%)\n",
    "What country has the maximum % Renewable and what is the percentage?\n",
    "\n",
    "*This function should return a tuple with the name of the country and the percentage.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 119,
   "metadata": {
    "umich_part_id": "014",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "('Brazil', 69.648030000000006)"
      ]
     },
     "execution_count": 119,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_six():\n",
    "    Top15 = answer_one()\n",
    "    return Top15['% Renewable'].argmax(), Top15['% Renewable'].max()\n",
    "\n",
    "answer_six()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 7 (6.6%)\n",
    "Create a new column that is the ratio of Self-Citations to Total Citations. \n",
    "What is the maximum value for this new column, and what country has the highest ratio?\n",
    "\n",
    "*This function should return a tuple with the name of the country and the ratio.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "umich_part_id": "015",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "(0.68931261793894216, 'China')"
      ]
     },
     "execution_count": 2,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_seven():\n",
    "    Top15 = answer_one()\n",
    "    Top15['ratio'] = Top15['Self-citations'] / Top15['Citations']\n",
    "    return Top15['ratio'].max(), Top15['ratio'].argmax()\n",
    "\n",
    "answer_seven()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 8 (6.6%)\n",
    "\n",
    "Create a column that estimates the population using Energy Supply and Energy Supply per capita. \n",
    "What is the third most populous country according to this estimate?\n",
    "\n",
    "*This function should return a single string value.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {
    "umich_part_id": "016",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'United States'"
      ]
     },
     "execution_count": 21,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_eight():\n",
    "    Top15 = answer_one()\n",
    "    Top15['Population_Estimates'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Top15 = Top15['Population_Estimates'].sort_values(ascending = False)\n",
    "    return Top15.index[2]\n",
    "\n",
    "answer_eight()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 9 (6.6%)\n",
    "Create a column that estimates the number of citable documents per person. \n",
    "What is the correlation between the number of citable documents per capita and the energy supply per capita? Use the `.corr()` method, (Pearson's correlation).\n",
    "\n",
    "*This function should return a single number.*\n",
    "\n",
    "*(Optional: Use the built-in function `plot9()` to visualize the relationship between Energy Supply per Capita vs. Citable docs per Capita)*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "umich_part_id": "017",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "0.79400104354429457"
      ]
     },
     "execution_count": 23,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_nine():\n",
    "    Top15 = answer_one()\n",
    "    Top15['Population_Estimates'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Top15['Citable docs per Capita'] = Top15['Citable documents'] / Top15['Population_Estimates']\n",
    "    return Top15['Citable docs per Capita'].corr(Top15['Energy Supply per Capita'], method='pearson')\n",
    "\n",
    "answer_nine()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "def plot9():\n",
    "    import matplotlib as plt\n",
    "    %matplotlib inline\n",
    "    \n",
    "    Top15 = answer_one()\n",
    "    Top15['PopEst'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Top15['Citable docs per Capita'] = Top15['Citable documents'] / Top15['PopEst']\n",
    "    Top15.plot(x='Citable docs per Capita', y='Energy Supply per Capita', kind='scatter', xlim=[0, 0.0006])"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7f644f7e14e0>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#plot9() # Be sure to comment out plot9() before submitting the assignment!"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 10 (6.6%)\n",
    "Create a new column with a 1 if the country's % Renewable value is at or above the median for all countries in the top 15, and a 0 if the country's % Renewable value is below the median.\n",
    "\n",
    "*This function should return a series named `HighRenew` whose index is the country name sorted in ascending order of rank.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {
    "umich_part_id": "018",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Country\n",
       "China                 1\n",
       "United States         0\n",
       "Japan                 0\n",
       "United Kingdom        0\n",
       "Russian Federation    1\n",
       "Canada                1\n",
       "Germany               1\n",
       "India                 0\n",
       "France                0\n",
       "South Korea           0\n",
       "Italy                 1\n",
       "Spain                 1\n",
       "Iran                  0\n",
       "Australia             0\n",
       "Brazil                1\n",
       "Name: % Renewable, dtype: int64"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_ten():\n",
    "    Top15 = answer_one()\n",
    "    HighRenew = (Top15['% Renewable'] > Top15['% Renewable'].median())\n",
    "    return HighRenew + 0\n",
    "\n",
    "answer_ten()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 11 (6.6%)\n",
    "Use the following dictionary to group the Countries by Continent, then create a dateframe that displays the sample size (the number of countries in each continent bin), and the sum, mean, and std deviation for the estimated population of each country.\n",
    "\n",
    "```python\n",
    "ContinentDict  = {'China':'Asia', \n",
    "                  'United States':'North America', \n",
    "                  'Japan':'Asia', \n",
    "                  'United Kingdom':'Europe', \n",
    "                  'Russian Federation':'Europe', \n",
    "                  'Canada':'North America', \n",
    "                  'Germany':'Europe', \n",
    "                  'India':'Asia',\n",
    "                  'France':'Europe', \n",
    "                  'South Korea':'Asia', \n",
    "                  'Italy':'Europe', \n",
    "                  'Spain':'Europe', \n",
    "                  'Iran':'Asia',\n",
    "                  'Australia':'Australia', \n",
    "                  'Brazil':'South America'}\n",
    "```\n",
    "\n",
    "*This function should return a DataFrame with index named Continent `['Asia', 'Australia', 'Europe', 'North America', 'South America']` and columns `['size', 'sum', 'mean', 'std']`*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {
    "umich_part_id": "019",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>size</th>\n",
       "      <th>sum</th>\n",
       "      <th>mean</th>\n",
       "      <th>std</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Continent</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>Asia</th>\n",
       "      <td>5.0</td>\n",
       "      <td>2.898666e+09</td>\n",
       "      <td>5.797333e+08</td>\n",
       "      <td>6.790979e+08</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Australia</th>\n",
       "      <td>1.0</td>\n",
       "      <td>2.331602e+07</td>\n",
       "      <td>2.331602e+07</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>Europe</th>\n",
       "      <td>6.0</td>\n",
       "      <td>4.579297e+08</td>\n",
       "      <td>7.632161e+07</td>\n",
       "      <td>3.464767e+07</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>North America</th>\n",
       "      <td>2.0</td>\n",
       "      <td>3.528552e+08</td>\n",
       "      <td>1.764276e+08</td>\n",
       "      <td>1.996696e+08</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>South America</th>\n",
       "      <td>1.0</td>\n",
       "      <td>2.059153e+08</td>\n",
       "      <td>2.059153e+08</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "               size           sum          mean           std\n",
       "Continent                                                    \n",
       "Asia            5.0  2.898666e+09  5.797333e+08  6.790979e+08\n",
       "Australia       1.0  2.331602e+07  2.331602e+07           NaN\n",
       "Europe          6.0  4.579297e+08  7.632161e+07  3.464767e+07\n",
       "North America   2.0  3.528552e+08  1.764276e+08  1.996696e+08\n",
       "South America   1.0  2.059153e+08  2.059153e+08           NaN"
      ]
     },
     "execution_count": 37,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_eleven():\n",
    "    Top15 = answer_one()\n",
    "    ContinentDict  = {'China':'Asia', \n",
    "                  'United States':'North America', \n",
    "                  'Japan':'Asia', \n",
    "                  'United Kingdom':'Europe', \n",
    "                  'Russian Federation':'Europe', \n",
    "                  'Canada':'North America', \n",
    "                  'Germany':'Europe', \n",
    "                  'India':'Asia',\n",
    "                  'France':'Europe', \n",
    "                  'South Korea':'Asia', \n",
    "                  'Italy':'Europe', \n",
    "                  'Spain':'Europe', \n",
    "                  'Iran':'Asia',\n",
    "                  'Australia':'Australia', \n",
    "                  'Brazil':'South America'}\n",
    "    Top15 = Top15.reset_index()\n",
    "    for country in Top15['Country']:\n",
    "        Top15['Country'] = Top15['Country'].replace(ContinentDict)\n",
    "    Top15 = Top15.rename(columns={'Country' : 'Continent'})\n",
    "    Top15['Population_Estimates'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    Continent = Top15.groupby('Continent')['Population_Estimates'].agg({'size' : np.size, 'sum' : np.sum, 'mean' : np.mean, 'std' : np.std})\n",
    "    return Continent\n",
    "\n",
    "answer_eleven()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 12 (6.6%)\n",
    "Cut % Renewable into 5 bins. Group Top15 by the Continent, as well as these new % Renewable bins. How many countries are in each of these groups?\n",
    "\n",
    "*This function should return a __Series__ with a MultiIndex of `Continent`, then the bins for `% Renewable`. Do not include groups with no countries.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 85,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Continent      bins            \n",
       "Asia           (2.212, 15.753]     4\n",
       "               (15.753, 29.227]    1\n",
       "Australia      (2.212, 15.753]     1\n",
       "Europe         (2.212, 15.753]     1\n",
       "               (15.753, 29.227]    3\n",
       "               (29.227, 42.701]    2\n",
       "North America  (2.212, 15.753]     1\n",
       "               (56.174, 69.648]    1\n",
       "South America  (56.174, 69.648]    1\n",
       "dtype: int64"
      ]
     },
     "execution_count": 85,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "def answer_twelve():\n",
    "    Top15 = answer_one()\n",
    "    ContinentDict  = {'China':'Asia', \n",
    "                  'United States':'North America', \n",
    "                  'Japan':'Asia', \n",
    "                  'United Kingdom':'Europe', \n",
    "                  'Russian Federation':'Europe', \n",
    "                  'Canada':'North America', \n",
    "                  'Germany':'Europe', \n",
    "                  'India':'Asia',\n",
    "                  'France':'Europe', \n",
    "                  'South Korea':'Asia', \n",
    "                  'Italy':'Europe', \n",
    "                  'Spain':'Europe', \n",
    "                  'Iran':'Asia',\n",
    "                  'Australia':'Australia', \n",
    "                  'Brazil':'South America'}\n",
    "    Top15 = Top15.reset_index()\n",
    "    for country in Top15['Country']:\n",
    "        Top15['Country'] = Top15['Country'].replace(ContinentDict)\n",
    "    Top15 = Top15.rename(columns={'Country' : 'Continent'})\n",
    "    Top15['bins'] = pd.cut(Top15['% Renewable'], 5)\n",
    "    Top15 = Top15.groupby(['Continent', 'bins']).size()\n",
    "    return Top15\n",
    "\n",
    "answer_twelve()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Question 13 (6.6%)\n",
    "Convert the Population Estimate series to a string with thousands separator (using commas). Do not round the results.\n",
    "\n",
    "e.g. 317615384.61538464 -> 317,615,384.61538464\n",
    "\n",
    "*This function should return a Series `PopEst` whose index is the country name and whose values are the population estimate string.*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 99,
   "metadata": {
    "scrolled": true,
    "umich_part_id": "020",
    "umich_partlist_id": "003"
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Country\n",
       "China                 1,367,645,161.2903225\n",
       "United States          317,615,384.61538464\n",
       "Japan                  127,409,395.97315437\n",
       "United Kingdom         63,870,967.741935484\n",
       "Russian Federation            143,500,000.0\n",
       "Canada                  35,239,864.86486486\n",
       "Germany                 80,369,696.96969697\n",
       "India                 1,276,730,769.2307692\n",
       "France                  63,837,349.39759036\n",
       "South Korea            49,805,429.864253394\n",
       "Italy                  59,908,256.880733944\n",
       "Spain                    46,443,396.2264151\n",
       "Iran                    77,075,630.25210084\n",
       "Australia              23,316,017.316017315\n",
       "Brazil                 205,915,254.23728815\n",
       "Name: PopEst, dtype: object"
      ]
     },
     "execution_count": 99,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "import locale\n",
    "def answer_thirteen():\n",
    "    Top15 = answer_one()\n",
    "    Top15['PopEst'] = Top15['Energy Supply'] / Top15['Energy Supply per Capita']\n",
    "    return Top15['PopEst'].apply(lambda x : '{:,}'.format(x))\n",
    "\n",
    "answer_thirteen()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Optional\n",
    "\n",
    "Use the built in function `plot_optional()` to see an example visualization."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 101,
   "metadata": {
    "collapsed": true,
    "scrolled": true
   },
   "outputs": [],
   "source": [
    "def plot_optional():\n",
    "    import matplotlib as plt\n",
    "    %matplotlib inline\n",
    "    Top15 = answer_one()\n",
    "    ax = Top15.plot(x='Rank', y='% Renewable', kind='scatter', \n",
    "                    c=['#e41a1c','#377eb8','#e41a1c','#4daf4a','#4daf4a','#377eb8','#4daf4a','#e41a1c',\n",
    "                       '#4daf4a','#e41a1c','#4daf4a','#4daf4a','#e41a1c','#dede00','#ff7f00'], \n",
    "                    xticks=range(1,16), s=6*Top15['2014']/10**10, alpha=.75, figsize=[16,6]);\n",
    "\n",
    "    for i, txt in enumerate(Top15.index):\n",
    "        ax.annotate(txt, [Top15['Rank'][i], Top15['% Renewable'][i]], ha='center')\n",
    "\n",
    "    print(\"This is an example of a visualization that can be created to help understand the data. \\\n",
    "This is a bubble chart showing % Renewable vs. Rank. The size of the bubble corresponds to the countries' \\\n",
    "2014 GDP, and the color corresponds to the continent.\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 102,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "This is an example of a visualization that can be created to help understand the data. This is a bubble chart showing % Renewable vs. Rank. The size of the bubble corresponds to the countries' 2014 GDP, and the color corresponds to the continent.\n"
     ]
    },
    {
     "data": {
      "image/png": "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\nU+4AAAAASUVORK5CYII=\n",
      "text/plain": [
       "<matplotlib.figure.Figure at 0x7f27d329f898>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "#plot_optional() # Be sure to comment out plot_optional() before submitting the assignment!"
   ]
  }
 ],
 "metadata": {
  "anaconda-cloud": {},
  "coursera": {
   "course_slug": "python-data-analysis",
   "graded_item_id": "zAr06",
   "launcher_item_id": "KSSjT",
   "part_id": "SL3fU"
  },
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.6.2"
  },
  "umich": {
   "id": "Assignment 3",
   "version": "1.5"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}
